ShowTable of Contents
Domino Designer now uses Eclipse help which is a bit different than the old NSF help. Probably the best access mechanism is search. The index is inconsistent and should be avoided.
Click
Help > Help Contents to bring up help in its own window. Notice that the help is for Lotus Domino Designer, Lotus Notes, and numerous other products depending on what's installed. Look for the following Domino Designer "books": Lotus Domino Designer Basic User Guide and Reference, Lotus Domino Designer XPages and Eclipse User Guide, and Lotus Domino Designer XPages Reference.
Tip 1 Use exact words or wildcards
The Search window is at the top left. Enter complete words. Enter the words precisely. By default you don't have to worry about case. Click
Go or (8.5.1 or later) hit
Return.
Suppose you are looking for the createFTIndex method. Entering
createftindex gives you a nice list of hits.
But
createft fails, as does
creatftindex. Eclipse does not ask you, "Do you really mean createftindex?"
You can use wildcards so
createft* brings up that nice list of hits!
One way to ensure accuracy is to copy and paste from the UI, for example, the script editor.
Tip 2 Hover or click to distinguish duplicates
The list of hits often shows the same or similar topic names especially for programming reference topics. For example, the first six hits for
createftindex are for various topics in LotusScript, Java, and JavaScript. Sometimes you can tell from the abstract which one you want but sometimes the information is insufficient.
Hover over a hit to see which book it is in. The hover information also appears on the status line at the bottom. For example, if the hover information shows that a
createftindex hit is in the Domino Designer XPages Reference, you know it is a JavaScript method. If the hit is in the Basic User Guide and Reference, it is LotusScript or Java.
Finally you can click on hits to see what comes up. Look at the breadcrumbs at the top of the page to see exactly where you are in the help hierarchy. For example,
Lotus Domino XPages Reference > Domino > NotesDatabase shows that this method is in the NotesDatabase class of the XPages Domino library. You can click on a breadcrumb to navigate up in the help hierarchy.
Tip 3 Limit the search scope
This is especially useful if you are only interested in part of help, for example, the LotusScript class reference. It takes a slight amount of setup but then your hit list will contain only the subject matter of interest. Here are the steps:
1. At the top of help, to the right of the search window, click Search scope.
2. In the dialog, click Search only the following topics.
3. Click New.
4. In the next dialog, provide a name for this search scope, for example, LotusScript classes.
5. Check the part or parts of help that you want to include in the search. You can drill down a level. For example, you might expand Lotus Domino Designer Basic User Guide and Reference then check LotusScript/COM/OLE Classes.
6. Click OK to go back to the first dialog. You can repeat the previous step to create additional search scopes.
7. Make sure the search scope you want is selected then click OK.
Tip 4 F1 opens help as the right pane of the main window
F1 brings up help in the right pane. You can adjust the size of the window and close it when you're done.
In some cases, F1 takes you to a specific topic. In particular, if you use F1 in the formula editor, the old LotusScript editor, or the old Java editor, it brings up the specific programming reference topic.
In many cases, especially when in the XPages, F1 brings up material that is summary in nature. You can navigate to fuller documentation by using the links or by clicking
Search or
All Topics at the bottom of the page. As you navigate, you remain in the F1-style help pane on the right side of the window.
Tip 5 Hover help in the Eclipse LotusScript editor is cool
The new LotusScript editor provides hover help that taps into the regular help. When you put focus on a keyword, the help topic for that keyword appears in its own box which can be sized and scrolled. In addition, you can use the breadcrumbs and other links to navigate elsewhere in help.
Tip 6 Interpolate for the XPages Domino Objects reference
The help for the Domino Objects in the Domino Designer XPages Reference is a work in progress. Its content and formatting is off in places and most of the examples have yet to be supplied. However you can go to the same Java or LotusScript topic, for example, to obtain an example. You will have to interpolate of course, but in general JavaScript is simpler than the other languages.
Tip 7 NSF help is still there
The NSF help is also available but contains only the legacy (non-XPages) documentation and is not available through the menu. From Notes (not Designer), click
File > Open > Lotus Notes Application or type
Ctrl+O. Scroll down and double-click the Help directory. Double-click Lotus Domino Designer 8.5.1 Help (help85_designer.nsf).
Tip 8 The information center is the same help as installed with the product
The information center at
http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp has the same information as the help installed with Domino Designer. This is handy if you:
- prefer to run help out of a browser
- don't want to install the help
- want to get help when Domino Designer is not running